Short:    Speed up your mathieee libraries!
Author:   thor@math.tu-berlin.de (Thomas Richter)
Uploader: thor@math.tu-berlin.de (Thomas Richter)
Version:  40.1
Type:     util/sys
Requires: Os 2.04, an 68040 (or an 68060), the MuLib 68040.library

-----------------------------------------------------------------------------

FastIEEE replaces the math library functions, i.e. entries of the 
mathieeesing/doub/bas/trans.libraries by routines which are more adequate for
a 68040 or 68060 processor. The advantage of the new routines is that they
no longer use FPU instructions that have to be emulated in software for the
68040 or 68060 processor. Hence, these routines go no longer thru an
"emulator trap", are therefore more multitasking friendly and also faster.
Some measurements have shown that the new IEEE routines provided by this
program are approximately 1.5 times faster.

NOTE THAT THIS MAKES ONLY A DIFFERENCE IF PROGRAMS REALLY USE THE MATHIEEE
LIBRARIES.

However, these procedures do not re-implement all the mathematical algorithms.
Instead, they make use of the "FPSP" routines which are already part of the
68040.library. Therefore, a special 68040 library is required which makes 
these routines available. Currently, the only 68040 library that offers this
feature is my 68040.library from the MuLib archive. In principle, the same
would be possible for the 68060, but as I do not own a 68060 board, I wasn't
able to write the required 68060.library.

FastIEEE fixes, too, some bugs in the mathieee libraries. IEEEDPCmp() is 
broken and orders some numbers "the wrong way". This fix is also available 
separately. IEEEDPPow() and IEEESPPow() are broken and return non-sense for 
special arguments.

------------------------------------------------------------------------------

This file is part of the MMULib distribution. To find out more about the
mmu.library and its goals, download util/libs/MMULib.lha.

------------------------------------------------------------------------------

Quick installation notes:

	- Copy LIBS/mmu.library to LIBS:
	- Copy LIBS/68040.library (or the 68030/68020 lib) to LIBS:
	- Optionally: Read the MMU.guide how to patch SetPatch and how
  	  to install the 680x0.library.
	- Copy ENVARC/MMU-Configuration to ENVARC:
	- Copy Shell_Only/FastIEEE to C:
	- Run FastIEEE in your startup sequence behind (!) SetPatch

------------------------------------------------------------------------------

                         The THOR-Software Licence (v2, 24th June 1998)


This License applies to the computer programs known as the "mmu.library",
the "680x0.library", the "68040.library V40" and "FastIEEE". The "Program", 
below, refers to such program. The "Archive" refers to the package of 
distribution, as prepared by the author of the Program, Thomas Richter. 
Each licensee is addressed as "you".



The Program and the data in the archive are freely distributable
under the restrictions stated below, but are also Copyright (c)
Thomas Richter.

Distribution of the Program, the Archive and the data in the Archive by a
commercial organization without written permission from the author to any
third party is prohibited if any payment is made in connection with such
distribution, whether directly (as in payment for a copy of the Program) or
indirectly (as in payment for some service related to the Program, or
payment for some product or service that includes a copy of the Program
"without charge"; these are only examples, and not an exhaustive enumeration
of prohibited activities).


However, the following methods of distribution
involving payment shall not in and of themselves be a violation of this
restriction:


(i) Posting the Program on a public access information storage and
retrieval service for which a fee is received for retrieving information
(such as an on-line service), provided that the fee is not
content-dependent (i.e., the fee would be the same for retrieving the same
volume of information consisting of random data).


(ii) Distributing the Program on a CD-ROM, provided that

a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
especially this licence agreement;

b) the CD-ROM is made available to the public for a nominal fee only,

c) a copy of the CD is made available to the author for free except for
shipment costs, and

d) provided further that all information on such CD-ROM is redistributable
for non-commercial purposes without charge.


Redistribution of a modified version of the Archive, the Program or the
contents of the Archive is prohibited in any way, by any organization,
regardless whether commercial or non-commercial. Everything must be kept
together, in original and unmodified form.




Limitations.


THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
SERVICING, REPAIR OR CORRECTION.


IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.


                                                        Thomas Richter

-----------------------------------------------------------------------------

So long,
	Thomas			(January 2000)


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
     628     264 57.9% 11-Dec-99 23:46:30 +EnvArc.info
    2697    1262 53.2% 11-Mar-00 11:30:46 +MMU-Configuration
    5592    2469 55.8% 23-Jan-00 20:54:32 +FastIEEE.readme
     628     272 56.6% 11-Dec-99 23:45:10 +Libs.info
   43368   23298 46.2% 30-Mar-00 22:33:00 +68040.library
   40372   21263 47.3% 01-Apr-00 23:36:48 +mmu.library
  150749   48869 67.5% 07-Apr-00 22:08:48 +MMU.guide
     523     274 47.6% 11-Dec-99 23:48:00 +MMU.guide.info
     628     271 56.8% 11-Dec-99 23:44:26 +Shell_Only.info
    3764    2042 45.7% 17-Jan-00 21:32:08 +FastIEEE
-------- ------- ----- --------- --------
  248949  100284 59.7% 10-Apr-100 10:14:50   10 files
